home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Light ROM 1
/
LIGHT-ROM 1 (Amiga Library Services)(1994).iso
/
ffdisks
/
d875.lha
/
APrf
/
APrf.doc
< prev
next >
Wrap
Text File
|
1992-12-20
|
44KB
|
1,046 lines
'.
APrf2 - Manuel d'utilisation
AboutThisDoc
Ce manuel décrit la version 2.10 de l'utilitaire APrf2. Ce programme
est (c)1989-1990-1991-1992 par Denis GOUNELLE, toute utilisation commerciale
ou vente sans autorisation écrite est strictement interdite. Vous pouvez
copier et diffuser ce programme aux conditions suivantes :
- l'ensemble des fichiers doit être fourni
- aucun fichier ne doit avoir été modifié
- vous ne devez pas demander plus de 40FF pour cela
"PowerPacker 2.3b" est (c)1989 par PowerPeak et Nico FRANCOIS,
"PowerPacker Pro 3.0b" est (c)1990 par PowerPeak et par UGA Software. La
bibliothèque "powerpacker.library" est (c)1990 par Nico FRANCOIS. AREXX est
(c)1987 par William Hawes. La bibliothèque "reqtools.library" est
(c)1990-1991 par Nico FRANCOIS.
Malgrès de nombreux tests, je ne peux garantir qu'APrf ne contient
aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES ET PERILS. Je ne
pourrai en aucun cas être tenu responsable de tout dommage, direct ou
indirect, résultant de l'utilisation d'APrf.
Introduction
APrf2 est une nouvelle version de APrf, capable d'utiliser les
fonctions de la version 2.0 du système. Ce programme peut toujours être
utilisé avec le système 1.3, bien que certaines des nouvelles possibilités
ne soient pas disponibles dans ce cas.
APrf est un utilitaire d'impression qui permet (entre autres)
l'ajout d'une entête, d'un pied de page, de marges, la numérotation des
lignes, l'impression sur plusieurs colonnes, etc... et utilise les valeurs
fixées dans les Préférences. APrf dispose de plus d'un port compatible
AREXX, d'une fenêtre d'application (ou "AppWindow", sous système 2.0
uniquement) et peut charger des fichiers compactés par "PowerPacker 2.3b" ou
par "PowerPacker Pro 3.0b".
Vous pouvez me faire part de vos remarques ou critiques sur APrf, en
écrivant à l'adresse suivante :
M. GOUNELLE Denis
Boite 71
6, rue des cailloux
92110 CLICHY - FRANCE
Vous pouvez également m'adresser un message à l'adresse Internet
"gounelle@alphanet.ch". Notez qu'il s'agit d'une boite à lettre mise à ma
disposition par un ami, aussi veuillez n'envoyer que de courts messages. De
plus, n'ayant pas accès directement à mes messages, n'espérez pas avoir une
réponse avant une dizaine de jours.
Merci à Serge HAMMOUCHE, Jean-Yves PROUX, Jean-Philippe RAPP, Jean
ROUGELIN, Michel SCHINZ, et Pierre VITET, pour leurs tests et leurs idées.
En France, la dernière version de ce programme est disponible auprès
de Serge HAMMOUCHE, 3 rue Anatole France, 13220 Chateauneuf-les-Martigues.
Pour recevoir le catalogue complet, il vous suffit d'envoyer deux timbres à
cette adresse.
Appel_depuis_le_CLI
Il n'y a pas besoin d'utiliser une commande "RunBack" ou "ARun", car
APrf se détache automatiquement de la fenêtre CLI. Vous pouvez appeler APrf
avec une série d'options qui permettent de modifier les paramêtres par
défaut. La syntaxe de la ligne de commande est :
APrf [fichier][-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF]
[-x#][-A][-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont]
[-N#][-Oopts][-P{p|e|f}][-Spages][-X]
Si on précise l'argument <fichier>, le fichier correspondant sera
considéré comme le fichier à imprimer. Voici la description des autres
options :
-c# (nombre de Colonnes)
Imprime sur # colonnes.
Valeur par défaut : # = 1.
Valeur minimale : # = 1. Valeur maximale : # = 999.
-d# (marge Droite)
Ajoute une marge droite de # caractères. Notez que les
marges fixées dans les Préférences sont prises en compte
quoi qu'il arrive.
Valeur par défaut : # = 0.
Valeur minimale : # = 0. Valeur maximale : # = 999.
-e# (Espacement)
Sépare les colonnes par # espaces.
Valeur par défaut : # = 1.
Valeur minimale : # = 1. Valeur maximale : # = 999.
-f#,# (Format de page)
Sélectionne le format de la page et les pages où faire la
présentation. Le premier # peut prendre les valeurs
suivantes :
0 pas de format particulier
1 ajoute une entête
2 ajoute un pied de page
3 ajoute une entête et un pied de page
Valeur par défaut : # = 1.
Le second # peut prendre les valeurs suivantes :
0 sur toutes les pages
1 sur toutes les pages sauf la première
2 sur les pages paires
3 sur les pages impaires
Valeur par défaut : # = 0
Il est possible de n'indiquer qu'un seul paramètre : les
formes "-f1,2", "-f1" et "-f,2" sont acceptées. Pour plus de
détails voir §2.6
-g# (marge Gauche)
Ajoute une marge gauche de # caractères. Notez que les
marges fixées dans les Préférences sont prises en compte
quoi qu'il arrive.
Valeur par défaut : # = 0.
Valeur minimale : # = 0. Valeur maximale : # = 999.
-n# (Numérotation des lignes)
Numérote les lignes (numéros de # chiffres).
Valeur par défaut : # = 0 (pas de numéros de ligne).
Valeur minimale : # = 0. Valeur maximale : # = 10.
-p# (longueur des Pages)
Imprime par pages de # lignes.
Valeur par défaut : "Paper Length" des Préférences.
Valeur minimale : # = 5. Valeur maximale : # = 999.
-t# (Tabulation)
Règle les positions des tabulations sur les colonnes #+1,
2#+1, 3#+1, etc...
Valeur par défaut : # = 8.
Valeur minimale : # = 1. Valeur maximale : # = 999.
-vF (Vers)
L'impression est redirigée vers le fichier F.
-x# (eXemplaires)
Imprime # exemplaires du fichier.
Valeur par défaut : # = 1.
Valeur minimale : # = 1. Valeur maximale : # = 999.
-A (mode AREXX)
Place APrf en mode AREXX (voir §3.3)
-Cseq (séquence de Contrôle)
Sélectionne la séquence de contrôle "seq" (voir §3.5).
-D# (format de la Date)
Indique le format de la date dans l'entête. # peut prendre
les valeurs :
0 format AmigaDOS (jj-mmm-aa)
1 format international (aa-mm-jj)
2 format américain (mm-jj-aa)
3 format européen (jj-mm-aa)
Valeur par défaut : # = 0.
Pour plus de détails voir §2.6.
-E{G|C|D}fmt (format de l'Entête)
Indique le format de l'entête.
Pour plus de détails voir §2.6.
-F{G|C|D}fmt (format du pied de page)
Indique le format du pied de page.
Pour plus de détails voir §2.6.
-Ifont (police Interne)
Sélectionne la police interne indiquée.
Pour plus de détails voir §3.5.
-N# (Numéro de la première page)
La numérotation des pages commence au nombre #.
Valeur par défaut : # = 1.
Valeur minimale : # = 1. Valeur maximale : # = 899.
-Oopts (Options)
Permet de modifier certaines options. "opts" est une
combinaison quelconque des caractères :
c qualité courrier
l qualité listing
8 interligne 8LPI
6 interligne 6LPI
C alimentation papier continu
F alimentation feuilles à feuilles
t tronque les lignes trop longues
f filtre les caractères de contrôle
a filtre les séquences d'échappement
k tampon de sortie d'un kilo-octets
n n'envoit pas de sauts de page
u souligne l'entête
Voir la description du menu "Options" au §2.5 pour plus de
détails.
-P{p|e|f} (Pas d'impression)
Permet de sélectionner le pas d'impression :
-Pp pica
-Pe elite
-Pf fine
Valeur par défaut : "Pitch" des Préférences.
-Spages (Sélection)
Permet de sélectionner les pages à imprimer. La sélection
peut prendre les formes suivantes :
x page x uniquement
i pages impaires
p pages paires
x-y pages x à y
x,y,z,... pages x,y,z,...
Vous pouvez également utiliser une combinaisons des quatre
dernières formes, comme par exemple "-S1,3,5-8" ou
"-Sp,1,3".
ATTENTION : les numéros de page indiqués dans la sélection
doivent tenir compte du numéro de la première page (voir
option -N)
-X (eXpress)
Lance APrf en mode eXpress (voir §3.2).
En cas d'erreur dans la ligne de commande, une fenêtre apparait sur
l'écran Workbench, portant le message "Arguments incorrects". Cliquez sur le
gadget "OK" pour la faire disparaitre, et relancez APrf après correction de
la ligne de commande.
Notez que le menu "Outils" possède une commande qui permet de savoir
quelles options de la ligne de commande correspondent aux options courantes
(voir §2.5 pour plus de détails).
Appel_depuis_le_Workbench
Il y a trois façon d'appeler APrf depuis le Workbench quand on veut
lui indiquer le ou les fichiers à imprimer :
- en double-cliquant sur une icône de type "Project" qui a APrf
comme outil par défaut ("Default tool")
- en cliquant sur une ou plusieurs icônes de fichiers puis en
double-cliquant sur l'icône d'APrf tout en gardant la touche
SHIFT enfoncée.
- en cliquant sur l'icône d'APrf (et éventuellement sur des icônes
de fichiers) puis en double-cliquant sur une icône de fichier
tout en gardant la touche SHIFT enfoncée.
Dans tous les cas, le ou les fichiers sélectionnés sont transmis à
APrf, qui affiche le nom du premier fichier dans le gadget "Fichier à
imprimer" (voir §2.4). La commande "Fichier suivant" du menu "Projet" permet
de passer au fichier suivant (voir §2.5), et la commande "Options défaut" du
menu "Outils" permet de revenir au premier fichier de la liste (voir §2.5).
Comme pour l'appel depuis le CLI, il est possible d'appeler APrf
avec des options. Pour ce faire, cliquez sur l'icône du fichier à imprimer,
appelez le menu "Icons" du Workbench et choisissez l'item "Information".
Ensuite, cliquez sur le gadget "New" de la zone "TOOL TYPES" et entrez les
options en respectant la syntaxe suivante :
APRF=[-c#][-d#][-e#][-f#,#][-g#][-n#][-p#][-t#][-vF][-x#]
[-Cseq][-D#][-E{G|C|D}fmt][-F{G|C|D}][-Ifont][-N#]
[-Oopts][-P{p|e|f}][-Spages]
Ces options sont décrites au paragraphe précédent (§2.1). Si vous
appelez APrf depuis le Workbench sans arguments (juste en double-cliquant
sur l'icône d'APrf) les options seront cherchées dans le champ "TOOL TYPES"
de l'icône d'APrf.
Notez que les options -A (mode AREXX) et -X (mode eXpress) ne
peuvent être utilisées en cas d'appel depuis le Workbench.
Démarrage
APrf utilise la version 2.0c de la bibliothèque "reqtools.library".
Vous devez donc copier cette bibliothèque dans le répertoire "LIBS:", si ce
n'est déjà fait.
Si tout se passe bien, un écran s'ouvre, sur lequel apparaissent une
vingtaine de gadgets. Un port AREXX est également ouvert (voir §3.3). Sous
système 2.0, APrf ouvre systématiquement une "AppWindow" (fenêtre
d'application, voir §3.4). Sinon, une fenêtre apparait sur l'écran
Workbench, indiquant le problème rencontré. Cliquez sur le gadget "OK" pour
la faire disparaitre, APrf s'arrête et retourne la valeur 10 (ERROR, voir
commande IF de l'AmigaDOS).
Il se peut que APrf rende la main sans dire pourquoi, c'est-à-dire
sans afficher aucun message, mais en retournant cependant la valeur 10. Ceci
ne peut se produire que dans trois cas :
- APrf n'a pu ouvrir la bibliothèque "reqtools.library"
- APrf n'a pu ouvrir la fenêtre pour afficher le message d'erreur
- APrf n'a pu ouvrir l'écran Workbench
Je suppose maintenant que le programme a démarré correctement. Les
deux chapitres qui suivent vont vous expliquer comment utiliser les gadgets
et les menus d'APrf. Si vous utilisez APrf pour la première fois, je vous
conseille de lancer le programme afin de pouvoir mieux suivre les
explications.
Les_gadgets
Ce paragraphe décrit les gadgets affichés sur l'écran, de haut en
bas et de gauche à droite.
Fichier à imprimer
Ce gadget indique le nom du fichier à imprimer.
Pour modifier sa valeur il suffit de cliquer dessus. Une boite
de requête apparait, vous permettant de choisir le fichier à
imprimer. Si vous cliquez sur le gadget "CANCEL", ou sur le
gadget "OK" sans avoir choisi de fichier, l'ancien nom de
fichier sera conservé.
Le caractère "*" apparait à droite du nom de fichier quand le
fichier est chargé en mémoire (voir §4.1).
Fichier de sortie
Ce gadget indique où sera envoyée l'impression. Par défaut il
indique "PRT:", mais cette valeur peut être changée à l'appel
grâce à l'option -v (voir §2.1).
Pour modifier la valeur de ce gadget, il suffit de cliquer
dessus. Une boite de requête apparait, vous permettant de
choisir le fichier de sortie. Si vous cliquez sur "CANCEL", le
fichier de sortie devient "PRT:".
Pages sélectionnées
Ce gadget indique quelles pages seront imprimées. Par défaut il
indique "*", ce qui signifie "toutes les pages", mais cette
valeur peut être changée à l'appel grâce à l'option -S (voir
§2.1).
Pour modifier la valeur de la sélection, reportez-vous au §2.8.
Les neufs gadgets suivants permettent de spécifier respectivement :
la taille de la marge gauche, la taille de la marge droite, la longueur des
tabulations, le nombre de lignes par page, le numéro de la première page, la
taille des numéros de lignes, le nombre de colonnes, l'espacement des
colonnes, et le nombre d'exemplaires à imprimer.
Chacun de ces gadgets indique la valeur actuelle du paramêtre
correspondant, suivit par une flèche vers le haut et une flèche vers le bas.
Vous pouvez cliquer sur la valeur, et la modifier au clavier (appuyez sur
Amiga-X pour effacer la valeur précédente, n'oubliez pas d'appuyer sur
<RETURN> pour valider la nouvelle valeur). Vous pouvez également cliquez sur
la flèche vers le haut pour augmenter la valeur, ou sur la flèche vers le
bas pour la réduire. Si la valeur ne change pas, c'est que vous avez atteind
la limite inférieure ou supérieure admise pour ce paramêtre. La valeur
augmente ou diminue automatiquement tant que vous appuyez sur le bouton
gauche de la souris.
Marge gauche : (voir §2.1, option -g)
Valeur par défaut : 0
Valeur minimale : 0
Valeur maximale : 999
Marge droite : (voir §2.1, option -d)
Valeur par défaut : 0
Valeur minimale : 0
Valeur maximale : 999
Tabulation : (voir §2.1, option -t)
Valeur par défaut : 8
Valeur minimale : 1
Valeur maximale : 999
Lignes par page : (voir §2.1, option -p)
Valeur par défaut : "Paper length" des Préférences
Valeur minimale : 5
Valeur maximale : 999
No première page : (voir §2.1, option -N)
Valeur par défaut : 1
Valeur minimale : 1
Valeur maximale : 899
La sélection des pages est effacée à chaque modification
du numéro de la première page.
No de lignes : (voir §2.1, option -n)
Valeur par défaut : 0 (pas de numéros de ligne)
Valeur minimale : 0 (pas de numéros de ligne)
Valeur maximale : 10
Colonnes : (voir §2.1, option -c)
Valeur par défaut : 1
Valeur minimale : 1
Valeur maximale : 999
Espacement : (voir §2.1, option -e)
Valeur par défaut : 1
Valeur minimale : 1
Valeur maximale : 999
Exemplaires : (voir §2.1, option -x)
Valeur par défaut : 1
Valeur minimale : 1
Valeur maximale : 999
Les cinq gadgets suivants proposent différentes valeurs, que vous
pouvez faire défiler en cliquant sur le gadget en forme de flèche affiché
juste à droite de la valeur. Si vous appuyez sur une des touches SHIFT en
même temps, les valeurs défileront en sens inverse.
Caractères
Ce gadget indique le pas d'impression. Par défaut, le pas
est celui indiqué dans le champ "Pitch" des Préférences,
mais cela peut être changé à l'appel grâce à l'option -P
(voir §2.1).
Police
Ce gadget indique la police interne à utiliser. Normalement
il s'agit de la police par défaut, mais cela peut être
changé à l'appel grâce à l'option -I (voir §2.1). Pour plus
de détails, voir §3.5.
Format Date
Ce gagdet indique dans quel format sera la date. Par défaut
le format est le format AmigaDOS, mais ceci peut être changé
à l'appel grâce à l'option -D (voir §2.1). Pour plus de
détails, voir §2.6.
Format Page
Ce gadget indique le format de page courant. Par défaut le
format est "entête", mais ceci peut être changé à l'appel
grâce à l'option -f (voir §2.1). Pour plus de détails, voir
§2.6.
sur
Ce gadget indique sur quelles pages seront ajoutés l'entête
et/ou le pied de page. Par défaut, ce sera sur toutes les
pages, mais ceci peut être changé à l'appel grâce à l'option
-f (voir §2.1). Pour plus de détails, voir §2.6.
Les gadgets suivants vous permettent de personnaliser l'entête et le
pied de page.
Entête
Ce gadget indique le format des trois parties de l'entête :
la partie gauche, la partie centrale, et la partie droite.
La valeur par défaut de chaque partie peut être changée à
l'appel grâce à l'option -E (voir §2.1).
Pour modifier la valeur d'une des parties, il vous suffit de
cliquer dessus : une fenêtre avec un gadget de chaine
apparait alors. Appuyez sur Amiga-X pour effacer la valeur,
sur RETURN pour valider, ou cliquez sur le bouton de
fermeture pour annuler l'opération.
Pour plus de détails, voir §2.6.
Pied de page
Fonctionne de la même façon que pour l'entête. La valeur par
défaut peut être changée à l'appel grâce à l'option -F (voir
§2.1). Pour plus de détails, voir §2.6.
Les deux gadgets en forme de losange, en bas de l'écran, permettent
de lancer l'impression (celui de gauche) et de lancer la pré-visualisation
(celui de droite) sans avoir à passer par les menus.
Vous pouvez également cliquer sur le gadget de fermeture de la
fenêtre principale (en haut à gauche) pour quitter le programme, ou sur le
gadget "zoom" (en haut à droite, sous système 2.0 uniquement) pour iconifier
APrf.
Les_menus
APrf possède trois menus : le menu "Projet", le menu "Outils" et le
menu "Options". Chaque commande peut être sélectionnée à l'aide de la souris
ou de raccourcis clavier, par contre les items du menu "Options" ne peuvent
être modifiés qu'à la souris. Les rubriques du menu "Projet" sont les
suivantes :
Fichier suivant (Amiga-F)
Si vous avez appelé APrf depuis le Workbench en
sélectionnant plusieurs fichiers, cette commande permet de
passer au fichier suivant dans la liste des fichiers
sélectionnés. Le gadget "Fichier à imprimer" est mis à jour
(voir §2.4) et l'ancien fichier est vidé de la mémoire (s'il
était chargé, voir §4.1).
Imprime (Amiga-P)
Lance l'impression.
Palette
Vous permet de modifier les couleurs de l'écran de APrf.
Pour sauvegarder la nouvelle palette immédiatement, appelez
la commande "Sauve config" et entrez "palette" comme nom de
configuration. Sinon, lorsque vous voudrez quitter le
programme, APrf vous demandera si vous voulez sauver la
nouvelle palette.
A Propos... (Amiga-?)
Affiche quelques informations sur APrf. Pour faire
disparaitre la fenêtre, cliquez à l'intérieur ou appuyez sur
une touche.
Iconifie (Amiga-I)
Iconifie APrf. L'écran d'APrf est fermé et, sous système 1.3
une petite fenêtre dont le titre est "APrf2 v2.10" vient se
placer dans le coin supérieur gauche de l'écran Workbench.
Sous système 2.0, la fenêtre d'application reste ouverte.
Notez que le port AREXX est toujours actif pendant que APrf
est iconifié.
Pour réveiller APrf, rendez cette fenêtre active puis
cliquez sur le bouton droit de la souris. Vous pouvez
quitter APrf lorsqu'il est iconifié sans avoir à le
réveiller, en cliquant sur le gadget de fermeture de la
fenêtre.
Quitte (Amiga-Q ou ESCAPE)
Termine l'exécution d'APrf. Une boite de requête apparaitra
pour vous demander confirmation.
Voici la description des commandes du menu "Outils" :
Options défaut (Amiga-D)
Permet de recharger les options par défaut (dans l'ordre :
valeurs des Préférences, puis options de la ligne de
commande). Si vous avez appelé APrf depuis le Workbench en
sélectionnant plusieurs fichiers, le premier fichier
sélectionné devient le fichier à imprimer.
Cette commande peut être utile (entre autres) si vous avez
changé les Préférences, car cela permet à APrf de prendre en
compte ces modifications sans que vous ayez à quitter le
programme.
Charge fichier (Amiga-C)
Permet de charger immédiatement le fichier à imprimer en
mémoire. Si ce fichier était déjà en mémoire, il est
rechargé quand même (voir §4.1).
Libère fichier (Amiga-L)
Permet de libérer la mémoire occupée par le fichier à
imprimer (voir §4.1)
Commande "Pré-visualise" (Amiga-V) :
Permet de visualiser la mise en page du fichier à imprimer.
(voir §2.7).
Ligne de cmd (Amiga-K)
Affiche la liste des options à donner à l'appel pour que les
paramêtres d'impressions aient leur valeur actuelle. Pour
faire disparaitre la fenêtre, cliquez à l'intérieur ou
appuyez sur une touche.
Sauve config (Amiga-S)
Sauve les options courantes (sauf le nom du fichier à
imprimer) en créant une nouvelle ligne dans le fichier
"S:APrf.Init". Une fenêtre apparait, et vous devez entrer le
nom de la nouvelle configuration. Cliquez sur le gadget de
fermeture de la fenêtre pour annuler l'opération. Notez que
le nouveau fichier de configuration n'est pas rechargé. Voir
§3.5 pour d'autres détails.
Doc info (Amiga-X)
Affiche le nombre de pages, de lignes et de caractères que
produira l'impression du fichier courant. Ce décompte tient
compte de toutes les options de mise en page, mais notez que
le nombre de caractères est approximatif. Pour faire
disparaitre la fenêtre, cliquez sur le gadget "OK".
Voici la description des items du menu "Options" :
Courrier
Permet de sélectionner la qualité d'impression : "courrier"
ou "listing". Par défaut la qualité est celle indiquée par
le champ "Print Quality" des Preferences, mais cela peut
être changé à l'appel par l'option -O (voir §2.1).
8 LPI
Permet de régler l'interligne : "8 LPI" ou "6 LPI". Par
défaut l'interligne est celui indiqué par le champ "Spacing"
des Préférences, mais cela peut être changé à l'appel par
l'option -O (voir §2.1).
Continu
Permet d'indiquer comment est alimentée votre imprimante :
par du papier en continu, ou feuille à feuille. Par défaut,
l'alimentation est celle indiquée par le champ "Paper type"
des Préférences, mais cela peut être changé à l'appel grâce
à l'option -O (voir §2.1).
Tronque
Si cette option est active, les lignes trop longues seront
tronquées au lieu d'être imprimées sur plusieurs lignes.
Normalement cette option n'est pas active, mais cela peut
être changé à l'appel grâce à l'option -O (voir §2.1).
Filtre CTRL
Si cette option est active, les caractères de contrôle (code
ASCII inférieur à 32 ou supérieur à 126) trouvés dans le
fichier à imprimer ne seront pas envoyés à l'imprimante.
Normalement cette option n'est pas active, mais cela peut
être changé à l'appel grâce à l'option -O (voir §2.1).
Filtre ANSI
Si cette option est active, les séquence d'échappement ANSI
(définies au §5) trouvées dans le fichier à imprimer ne
seront pas envoyés à l'imprimante. Normalement cette option
n'est pas active, mais cela peut être changé à l'appel grâce
à l'option -O (voir §2.1).
Tampon 1Ko
Si cette option est active, le tampon de sortie aura une
taille d'un kilo-octet (et non d'une page). Normalement
cette option n'est pas active, mais cela peut être changé à
l'appel grâce à l'option -O (voir §2.1). Voir §4.2 pour plus
de détails.
Envoie FF
Si cette option est active, un caractère "saut de page"
(Form Feed) est envoyé à la fin de chaque page. Normalement
cette option est active, mais cela peut être changé à
l'appel grâce à l'option -O (voir §2.1).
Soul.entête
Si cette option est active, l'entête sera souligné lors de
l'impression. Normalement cette option n'est pas active,
mais cela peut être changé à l'appel grâce à l'option -O
(voir §2.1).
Entête_et_pied_de_page
APrf vous permet d'ajouter une entête, un pied de page, ou les deux,
sur vos documents. Le choix se fait soit à l'appel (option -f, voir §2.1)
soit avec le gadget "Format Page" (voir §2.4). L'entête et le pied de page
utilisent chacun deux lignes sur la page.
Lorsque vous demandez une entête (et/ou un pied de page), APrf
utilise la valeur des gadgets "Entête" (et/ou "Pied de page") pour composer
cette entête (et/ou ce pied de page). Le gadget à gauche indique ce qui sera
écrit à gauche, le gadget central ce qui sera écrit au milieu, et le gadget
à droite ce qui sera écrit à droite. Les spécifications de format peuvent
utiliser les séquences suivantes :
%a nom du jour de la semaine (e.g. "Lundi")
%b nom du mois (complet, e.g. "septembre")
%B nom du mois (abbrégé, e.g. "Sep")
%d jour du mois (01 à 31)
%D date telle qu'indiquée par le gadget "Format Date"
%f nom de base du fichier (e.g. "toto")
%F nom complet du fichier (e.g. "RAM:titi/toto")
%h heure (00 à 11)
%H heure (00 à 23)
%m mois (01 à 12)
%M minutes (00 à 59)
%n numéro de page
%p période de la journée (AM ou PM)
%s taille du fichier en octets
%S secondes (00 à 59)
%v version du programme (e.g. "APrf v4.20")
%w jour de la semaine (0 à 6)
%x numéro d'exemplaire
%y année (00 à 99)
La valeur par défaut de l'entête est "%f" pour la partie gauche,
"Page %n" pour la partie centrale, et "%D" pour la partie droite. La valeur
par défaut du pied de page est "Page %n" pour la partie centrale, et rien
pour les autres parties.
Vous avez la possibilité d'indiquer un format différent pour
l'entête (et/ou le pied de page), soit en cliquant sur le gadget
correspondant à la partie que vous voulez modifier, soit à l'appel avec
l'option -E (et/ou l'option -F) : "-EGformat" modifie la valeur par défaut
de la partie gauche, "-ECformat" celle de la partie centrale, et "-EDformat"
celle de la partie droite.
Vous pouvez également préciser sur quelles pages doivent apparaitre
l'entête (et/ou le pied de page), soit avec le gadget "sur" (voir §2.4),
soit à l'appel à l'aide de l'option -f (voir §2.1).
Pré_visualisation
Cette fonction vous permet de voir l'aspect final du texte en
fonction des options de mise en page. Pour l'utiliser, réglez tous les
paramêtres d'impression, puis choisissez la commande "Pré-visualise" du menu
"Outils". Une fenêtre apparait au milieu de l'écran, et vous montre le
résultat de la mise en page en commençant par la première page sélectionnée
(la taille de la fenêtre est fonction de la taille de la page).
Pour passer à la page suivante, cliquez à l'intérieur de la fenêtre,
ou appuyez sur la touche RETURN. A tout moment vous pouvez arrêter
l'opération en cliquant sur le gadget de fermeture ou en appuyant sur la
touche ESCAPE.
Notez cependant que si la longueur des pages est très grande (plus
de 120 lignes en mode PAL, ou plus de 90 lignes en mode NTSC), APrf ne
pourra pas ouvrir la fenêtre de pré-visualisation.
Modification_de_la_sélection
Pour modifier la sélection des pages à imprimer, cliquez sur le
gadget "Pages sélectionnées". Une fenêtre apparaitra au milieu de l'écran.
La partie supérieure de cette fenêtre est une grille de 100 cases, dont les
numéros correspondent aux numéros de pages. Les numéros sont écrits en noir
sur blanc si la page correspondante est sélectionnée, en noir sur bleu dans
le cas contraire. Si vous cliquez sur un numéro, vous inverserez la
sélection de la page correspondante. Vous avez également à votre disposition
les gadgets suivants :
TOUT sélectionne toutes les pages
INVERSER inverse la sélection
RIEN aucune page n'est sélectionnée
VALIDER validation de la nouvelle sélection (ou RETURN)
REPRENDRE reprise de la sélection précédente
ANNULER annulation de la nouvelle sélection (ou ESCAPE)
Vous pouvez également utiliser le gadget de chaine pour spécifier de
nouvelles pages à sélectionner (en plus de celles qui le sont déjà). Les
valeurs admises dans ce gadget sont :
* toutes les pages
x page x uniquement
p pages paires
i pages impaires
x-y pages x à y
x,y,z,... pages x,y,z,...
Vous pouvez utiliser une combinaisons des deux dernières formes,
comme par exemple "1,3,5-8" ou "p,1,3".
N'oubliez pas que la sélection dépend du numéro de la première page.
Notez enfin que vous ne pourrez valider si aucune page n'est sélectionnée.
La_bibliothèque_powerpacker.library
APrf utilise la bibliothèque "powerpacker.library", si elle est
présente dans le répertoire LIBS: de votre disquette Workbench ou de votre
disque dur. Ceci vous permet de demander l'impression d'un fichier compacté
par les logiciels "PowerPacker 2.3b" ou "PowerPacker Pro 3.0b" : le fichier
sera automatiquement décompacté lors de son chargement. Si le fichier avait
été crypté, APrf vous demandera le mot de passe nécessaire à son décodage.
Le_mode_eXpress
Il peut arriver que vous ayez envie d'imprimer un fichier
rapidement, sans faire appel à l'interface Intuition d'APrf (si vos
Préférences sont réglées correctement c'est sans doute souvent le cas). Dans
ce but, l'option -X a été ajouté à APrf : en présence de cette option, une
fois la ligne de commande analysée, l'impression démarre directement. APrf
n'ouvre pas d'écran, et s'arrête une fois l'impression achevée. Les messages
d'erreur éventuels sont affichés sur l'écran Workbench, dans une fenêtre
spéciale.
Le_mode_AREXX
Lors du démarrage, APrf ouvre systématiquement un port compatible
AREXX nommé "APrf_rexx" et attend des messages sur ce port. Les messages
peuvent être :
quit APrf ferme le port AREXX et termine
wakeup APrf ferme le port AREXX et lance l'interface
Intuition
reset APrf recharge les Préférences et revient aux options
par défaut
load APrf charge en mémoire le fichier à imprimer. Si
vous envoyez un message "load" sans avoir auparavant
indiqué le nom du fichier à imprimer, la commande
restera sans effet.
print APrf lance l'impression
Tout autre message est considéré comme des arguments et analysé de
la même manière (voir §2.1 pour la syntaxe). En cas d'erreur APrf affiche un
message sur l'écran Workbench, dans une fenêtre spéciale, et termine.
Voici un exemple de programme AREXX, qui lance l'impression du
fichier "S:Startup-Sequence" avec une marge gauche de 10 caractères, puis
termine APrf :
/* Imprime S:Startup-Sequence */
ADDRESS "APrf_rexx"
"S:Startup-Sequence -g10"
"print"
"quit"
Notez les guillemets autour des commandes !
Si vous indiquez l'option "-A" lors de l'appel d'APrf, celui-ci
passe en mode AREXX : seule la fenêtre d'application (sous système 2.0) ou
la fenêtre d'iconification (sous système 1.3) est ouverte et le programme se
met automatiquement en mode iconifié (voir §2.5). Depuis l'interface
Intuition, vous pouvez placer APrf en mode AREXX simplement en iconifiant le
programme (commande "Iconifie" du menu "Projet" voir §2.5).
La_fenêtre_d'application
Sous système 2.0, APrf ouvre automatiquement une fenêtre
d'application (ou "AppWindow") sur l'écran Workbench. Vous avez alors les
possibilités suivantes :
- si vous sélectionnez une ou plusieurs icônes, et que vous les
faites glisser sur la fenêtre d'application, APrf fera passer
son écran au premier plan (après l'avoir éventuellement ouvert),
et vous pourrez alors imprimer le ou les fichiers comme si vous
aviez appelé APrf depuis le Workbench.
- si vous cliquez sur le gadget de fermeture de la fenêtre
d'application, le programme s'arrêtera (sans confirmation en
mode AREXX)
- si vous activez la fenêtre d'application et cliquez sur le
bouton droit de la souris, APrf ouvrira son écran et l'interface
normale sera alors utilisable (équivalent à la commande "wakeup"
depuis AREXX)
- vous pouvez sauvegarder la taille et la position de la fenêtre
d'application, en indiquant "appwin" comme nom de configuration
(voir commande "Sauveg config" au §2.5)
Notez que la fenêtre d'application remplace la fenêtre
d'iconification.
Le_fichier_APrf.Init
Lors du démarrage, APrf essaye d'accéder au fichier "S:APrf.Init".
Ce fichier vous permet de définir des configurations type et/ou des polices.
Dans le premier cas, les lignes du fichier doivent avoir le format suivant :
nom:options:séquence
où "nom" et "options" sont des suites de caractères quelconques (il est
conseillé de ne pas dépasser 8 caractères pour "nom"), et "séquence" est une
suite de code décimaux, séparés par des espaces. Les parties "options" et
"séquence" peuvent être vides. Seules les 8 premières configurations type
sont prises en compte. Voici quelques exemples de lignes :
mon8lpi:-p90 -O8:
landscap:-p80:27 48 108 72
Chaque nom indiqué apparaitra dans un nouveau menu : le menu "Contrôle". Si
vous sélectionnez un nom dans ce menu, la chaine "options" sera
immédiatement analysée comme une ligne de commande CLI. De plus, lors de
l'impression, les caractères dont le code ASCII est indiqué dans la séquence
correspondante seront envoyées à l'imprimante (après les séquences normales
d'initialisation, mais avant le texte lui-même). Vous pouvez bien entendu
sélectionner plusieurs noms en même temps.
Lors d'un appel depuis le CLI ou depuis le Workbench, l'option -C
(voir §3.1) permet de sélectionner une séquence dès le démarrage. La chaine
"option" sera analysée après les options d'appel. Si la séquence spécifiée
par l'option -C n'existe pas, cette option sera ignorée.
Le fichier "S:APrf.Init" vous permet également d'utiliser, depuis
APrf, les polices internes de votre imprimante. Pour cela, il vous suffit de
rajouter une ligne de la forme :
fontdef:nom:séquence
où "nom" est le nom de la police, et "séquence" la suite de codes faisant
passer votre imprimante dans la police indiquée. Voici un exemple :
fontdef:Prestige:27 107 2 27 120 49
Le nombre de polices n'est pas limité. La sélection de la police peut se
faire soit à l'appel, à l'aide de l'option -I (voir §2.1), soit à l'aide du
gadget "Police" (voir §2.4). Il est conseillé de placer les définitions de
police en début de fichier, avant la définition des configurations type.
Vous pouvez également indiquer les couleurs à utiliser pour l'écran
de APrf, avec une ligne de la forme :
palette: c1 c2 c3 c4
où "c1", "c2", "c3" et "c4" sont les spécifications RVB de chaque couleur.
Vous pouvez indiquer ces valeurs en décimal ou en hexadécimal (dans ce cas,
ajoutez "0x" devant la valeur, par exemple "0x0F00"). Si vous indiquez
plusieurs palettes, seule la dernière sera prise en compte.
Enfin, il est possible de préciser la taille et la dimension de la
fenêtre d'application (sous système 2.0 uniquement) avec une ligne de la
forme :
appwin: x y l h
où "x", "y", indiquent la position du coin supérieur gauche, "l" la largeur
et "h" la hauteur de la fenêtre. Notez qu'il n'y a aucun contrôle sur les
valeurs que vous indiquez, en cas d'erreur la fenêtre ne sera pas ouverte.
APrf accepte des lignes vides dans le fichier. Une ligne commençant
par un point-virgule (";") sera considérée comme un commentaire et ne sera
donc pas interprétée.
Le fichier "S:APrf.Init" sera rechargé chaque fois que vous
sélectionnerez la commande "Options défaut" dans le menu "Outils". En mode
eXpress (voir §3.2), le fichier "S:APrf.Init" ne sera chargé qu'en cas de
besoin, c'est-à-dire si vous indiquez une option -C ou -I. Notez enfin que
les séquences sont envoyées par une commande PRD_RAWWRITE, c'est-à-dire
qu'elles ne seront pas interprétées par le pilote d'imprimante.
Gestion_de_la_mémoire
Avant d'imprimer ou de pré-visualiser un fichier, APrf le charge
entièrement en mémoire. Une fois le traitement terminée, le fichier est
conservé en mémoire, ce qui permet d'éviter de le recharger à nouveau si
vous demandez ensuite une impression ou une pré-visualisation de ce même
fichier.
La mémoire occupée par le fichier est libérée automatiquement quand
APrf est iconifié (voir §2.5), quand vous choisissez un nouveau fichier à
imprimer (voir §2.4), ou quand vous choisissez la commande "Fichier suivant"
du menu "Projet" (voir §2.5). Le fichier peut également être libéré (mais
dans certains cas seulement) si vous choisissez la commande "Options par
défaut" du menu "Outils".
Vous pouvez forcer APrf à charger immédiatement le fichier à
imprimer avec la commande "Charge fichier" du menu "Outils". Si le fichier
était déjà présent en mémoire, il sera rechargé quand même. Vous pouvez
également forcer APrf à libérer la mémoire occupée par le fichier avec la
commande "Libère fichier" du menu "Outils".
Pour vous permettre de savoir si le fichier est chargé en mémoire ou
non, APrf affiche le caractère "*" à droite du nom du fichier quand il est
chargé en mémoire.
Ce mode de fonctionnement peut avoir deux inconvénients. Le premier
est que le fichier occupe de la mémoire peut-être inutilement (je pense ici
à ceux qui n'ont que 512 Ko de mémoire). Dans ce cas, vous pouvez soit
iconifier APrf (voir §2.5, vous gagnez en plus la mémoire occupée par le
tampon de sortie, par quelques zones de travail, et au moins 32 Ko de
mémoire CHIP), soit utiliser la commande "Libère fichier" du menu "Outils".
Le second est que si vous modifiez le fichier sur disquette, ces
modifications pourraient ne pas être prises en compte, puisque APrf ne
recharge pas le fichier. Pour éviter cela, APrf essaye de détecter si le
fichier a été modifié depuis le dernier chargement en mémoire, et si tel est
le cas vous propose de le recharger.
Le_tampon_de_sortie
APrf utilise un tampon de sortie, afin de réduire le nombre d'ordres
d'écriture. Avec un tampon d'un kilo-octets, l'écriture vers un fichier se
fait au moins deux fois plus rapidement qu'avec les premières versions
d'APrf, dont le tampon ne contenait qu'une ligne. L'écriture vers
l'imprimante n'est pas accélérée de manière visible. Dans tous les cas, le
nombre d'ordres d'écriture est divisé au moins par 5 (cela peut aller
jusqu'à 14 ou 15), ce qui réduit sensiblement la charge imposée au systême,
et PERMET AINSI DE MOINS RALENTIR LES AUTRES TACHES.
Par défaut APrf utilise un tampon d'une page (voir §2.5 l'option
"Tampon 1Ko" du menu "Options"), afin de réduire encore plus le nombre
d'ordres d'écriture. Quand vous changez la taille de la page, le tampon est
automatiquement ré-alloué pour pouvoir contenir une page entière. S'il n'y a
plus assez de mémoire pour allouer un tampon d'une page, APrf réduit
automatiquement la taille du tampon à un kilo-octet. S'il n'est pas possible
d'allouer ce tampon d'un kilo-octets, APrf s'arrête et affiche le message
d'erreur "Plus de mémoire libre".
Divers
Ce chapitre est un bric-à-brac de quelques indications qui n'ont pas
trouvé place dans les autres chapitres. Il contient certains détails
importants sur le fonctionnement du programme. Je vous conseille donc de
lire attentivement ce qui suit, au moins une fois, et de penser à le relire
si APrf vous semble se comporter de manière bizarre.
Voici comment APrf réagit si l'option "Continu" est désactivée :
avant d'envoyer une page à l'imprimante, une boite de requête apparait, vous
demandant d'introduire une nouvelle feuille dans l'imprimante. Quand vous
êtes prêt, cliquez sur "OUI" : la page sera envoyée à l'imprimante. Si vous
cliquez sur "NON" l'impression sera abandonnée.
Si vous désirez interrompre une impression, cliquez dans le cadre où
est affiché le numéro de l'exemplaire et de la page en cours d'impression.
Une boite de requête apparait alors, pour vous demander confirmation :
cliquez sur "OUI" pour arrêter l'impression, ou cliquez sur "NON" pour
reprendre l'impression.
Si vous confirmez l'arrêt de l'impression, l'envoi des données à
l'imprimante est alors suspendu, ce qui ne veut pas forcément dire que
l'impression s'arrête tout de suite : il faut attendre que l'imprimante ait
vidé son tampon. Un message apparait pour vous informer que votre demande a
été prise en compte, et APrf attend que l'ordre d'écriture en cours soit
terminé (cela peut prendre un certain temps !).
Pour vous permettre d'améliorer la présentation de vos documents,
APrf reconnait les séquences ANSI suivantes :
ESC[0m caractères normaux
ESC[3m début d'italique
ESC[23m fin d'italique
ESC[4m début de souligné
ESC[24m fin de souligné
ESC[1m début de gras
ESC[22m fin de gras
ESC[1"z qualité listing
ESC[2"z qualité courrier
Ces séquences sont envoyées à l'imprimante, mais les caractères qui les
composent ne sont pas pris en compte dans le calcul de la mise en page. De
même, ils n'apparaissent pas lors de la pré-visualisation. Toute autre
séquence ne sera pas reconnue, et sera considéré comme faisant partie du
texte à imprimer. Vous pouvez filtrer ces séquences, si vous ne souhaitez
pas qu'elles soient envoyées à l'imprimante (voir §2.5, option "Filtre ANSI"
du menu "Options").
La taille de ces séquences est limitée à 32 caractères par LIGNE DE
SORTIE (et non par ligne du fichier à imprimer). Cela correspond à 6 ou 8
séquences, et devrait être suffisant dans la plupart des cas. S'il y a trop
de séquences sur une ligne de sortie, le message d'erreur "Lignes trop
longues, impression abandonnée" apparaitra en cours d'impression.
Sauf si le filtrage des caractères de contrôle est actif, un
caractère "Saut de page" dans le fichier à imprimer provoquera un saut de
page lors de l'impression. Notez enfin que les caractères "Backspace" (code
ASCII 8) ne sont pas comptés lors de la composition des lignes.
2.1 alias Appel_depuis_le_CLI
2.2 alias Appel_depuis_le_Workbench
2.3 alias Démarrage
2.4 alias Les_gadgets
2.5 alias Les_menus
2.6 alias Entête_et_pied_de_page
2.7 alias Pré_Visualisation
2.8 alias Modification_de_la_sélection
3.1 alias La_bibliothèque_powerpacker.library
3.2 alias Le_mode_eXpress
3.3 alias Le_mode_AREXX
3.4 alias La_fenêtre_d'application
3.5 alias Le_fichier_APrf.Init
4.1 alias Gestion_de_la_mémoire
4.2 alias Le_tampon_de_sortie
5 alias Divers